home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / povray / docs / amiga.doc next >
Text File  |  1995-01-12  |  6KB  |  151 lines
  1. This file contains the documentation specific to the Amiga version of
  2. POVRay2.0.
  3.  
  4. Differences From Original Distribution:
  5.  
  6.    The original distribution of POVRay2.0 is in ZIP format and contains
  7.    files in MS-DOS format.  The filenames are restricted to 8.3 characters
  8.    and the text files contain CRLF line terminators.  A script and a
  9.    utility to strip CRs, restore the long Amiga filenames, and create
  10.    icons is provided in the POVRAY/MACHINE/AMIGA directory.  Note that
  11.    none of the POVRay2.0 data files need be stripped of CRs as POVRay2.0
  12.    accepts data files both with and without CRs.
  13.  
  14.    There are custom Amiga executable, documentation, and scene archives
  15.    that have been converted to LZH format and have been stripped of all CR
  16.    characters and include long Amiga filenames and Amiga icons.  The Amiga
  17.    executable archive contains two executable versions of POVRay2.0, a
  18.    68881 and an IEEE version, and two executable programs that perform
  19.    image postprocessing, one to HAM6 and one to IFF24.  Otherwise, the
  20.    Amiga distribution is identical to the ZIP distribution.
  21.  
  22. SEE POVLEGAL.DOC FOR USE AND DISTRIBUTION TERMS.
  23.  
  24.    The Amiga archive in LZH format is an officially supported and
  25.    distributed format.
  26.  
  27. Executables:
  28.  
  29.    Two executables are provided:
  30.       povray881  - The version for systems with 68881 math coprocessors.
  31.       povrayieee - The version for systems without a coprocessor.
  32.  
  33. Running POVRay2.0:
  34.  
  35.    When running POVRay2.0, be sure that you have a large stack set.  If
  36.    the stack is too small, POVRay2.0 could crash without warning.  Mine
  37.    is set to 80,000 bytes.
  38.  
  39. Memory Requirements:
  40.  
  41.    POVRay2.0 can run on simple files with 1 Meg of memory.  I would
  42.    highly recommend having more memory to render more complicated
  43.    scenes.  There is a known bug in this version which prevents POVRay2.0
  44.    from cleaning up gracefully if it runs out of memory in some instan-
  45.    ces.  If this occurs, the cancel requestor will not be closed.  If you
  46.    click on it, the system will probably hang or reboot.  This should be
  47.    fixed in the next release.
  48.  
  49. Display Formats:
  50.  
  51.    The Amiga version of the raytracer supports three types of display
  52.    formats:
  53.       +d, +d0 - default
  54.       +d1     - HAM6
  55.       +dE     - HAME
  56.       +dF     - Firecracker
  57.  
  58.    By default, a display will be generated in HAM6 according to the image
  59.    size.  If the image is wider than 368 pixels, the display's horizontal
  60.    mode is hi-res, otherwise it is lo-res.  If the image is taller than
  61.    241 pixels, the display's vertical mode is interlaced, otherwise it is
  62.    non-interlaced.  Images that are smaller than the nominal screen size
  63.    are centered in the display screen.  Images that are larger than the
  64.    nominal screen size are displayed in overscan.  Note that not all
  65.    machines can display a hi-res HAM6 screen.  If your machine cannot
  66.    display a particular screen, the screen-open call will fail and an
  67.    error will be displayed.
  68.  
  69.    The HAME mode is always 320 x 200 pixels.
  70.  
  71.    The firecracker mode adjusts the resolution according to the -w
  72.    (width) parameter of the raytracer.
  73.  
  74.       320  <= w < 0     use 320  x 482
  75.       640  <= w < 320   use 640  x 482
  76.       768  <= w < 640   use 768  x 482
  77.       1024 <= w < 768   use 1024 x 482
  78.  
  79. File Formats:
  80.  
  81.    The default file format for the Amiga is "dump" format (+fd).  Targa
  82.    or raw may be specified on the command line or in the povray.def file.
  83.  
  84. Building The Source:
  85.  
  86.    POVRay2.0 was compiled using SAS C version 5.10b.  I'm sure that later
  87.    versions will work.  If you're compiling with another compiler, you'll
  88.    have to edit the makefile to set the proper compiler options.  As far
  89.    as that goes, you're on your own.
  90.  
  91.    To compile POVRay2.0 from the original source, follow these instruc-
  92.    tions:
  93.       1) From a shell, CD to the POVRAY/MACHINE/AMIGA directory and
  94.          "execute dos2ami",  which is a script that will strip CRs from
  95.          the text files, restore long filenames, and install some icons.
  96.       2) Copy the files in the POVRAY/SOURCE directory into a POVRAY/
  97.          BUILD directory.
  98.       3) Copy from the POVRAY/MACHINE/AMIGA directory files 'amiga.c',
  99.          'config.h', and 'makefile' to the POVRAY/BUILD directory.
  100.       4) If you're building an IEEE executable, you must edit the
  101.          makefile and comment out the line for "CFLAGS = ..." for the
  102.          '881, uncomment the line "CFLAGS = ..." for the IEEE emulator,
  103.          and type "lmk povrayieee".
  104.       5) To compile a 68881 version of POVRay2.0, leave the original
  105.          makefile unaltered and type "lmk".
  106.  
  107. Post-Processing Images:
  108.  
  109.    Two utilities called dump2iff and dump2i24 have been included in the
  110.    executable archive to convert the POVRay2.0 format output to HAM6 and
  111.    IFF24 format.  To run these utilities, you must provide the names of
  112.    the input and output files.
  113.    eg.
  114.       dump2iff picture.dis picture.ham
  115.  
  116.    The dump2iff program can also write out a file containing the palette
  117.    it used to make the image.  It can then be told to use this palette
  118.    for when converting other images.  This is useful for making
  119.    animations for animation players that can't change color palettes
  120.    between frames.
  121.  
  122.    To output a palette, use the -p option of dump2iff:
  123.       dump2iff -ppicture.pal picture.dis picture.ham
  124.  
  125.    To use this palette for other images, simply add it to the command
  126.    line:
  127.       dump2iff pic2.dis pic2.ham picture.pal
  128.  
  129.    By default, dump2iff will perform dithering to help smooth out the
  130.    color changes.  To disable dithering, use -d on the command line.
  131.  
  132.    The dump2i24 program does not generate a palette.  The 24-bit pixel
  133.    data is stored directly into 24 bit-planes.  You must provide the
  134.    names of the input and output files.
  135.    eg.
  136.       dump2i24 picture.dis picture.i24
  137.  
  138.    "The Art Department Professional" by ASDG does a fine job of post-
  139.    processing images.  ADPro can accept QRT format images (which is the
  140.    format output by POVRay2.0 with the +fd command-line parameter).  Al-
  141.    ternatively, you can output Targa (+ft) or raw (+fr).  To read the raw
  142.    format into ADPro, use the Scuplt reader.  You'll have to type in the
  143.    resolution you used to generate the image.
  144.  
  145.    This document is based on text originally by David K. Buck.
  146.  
  147. Comments and suggestions about the Amiga version can be directed to me:
  148.    Dave Park
  149.    Internet:   70004.1764@compuserve.com
  150.    CompuServe: [70004,1764]
  151.